SSH 터널링

작성자

익명

작성일

2026.08.09

조회수

버전

SSH 터널링 (SSH Tunneling)

1. 개요

SSH 터널링(SSH Tunneling)이란 보안되지 않은 네트워크 트래픽을 SSH(Secure Shell) 프로토콜의 암호화된 연결 내부에 캡슐화하여 전송함으로써, 데이터의 기밀성을 보장하고 방화벽 등의 네트워크 제약을 우회하는 네트워크 기술이다.

SSH는 기본적으로 원격 서버에 안전하게 접속하기 위한 프로토콜이지만, 포트 포워딩(Port Forwarding) 기능을 통해 특정 포트의 트래픽을 다른 목적지로 전달하는 '터널' 역할을 수행할 수 있다. 이를 통해 암호화되지 않은 프로토콜(HTTP, VNC, MySQL 등)을 사용하는 서비스도 SSH의 강력한 암호화 계층을 통해 안전하게 통신할 수 있다.

2. 작동 원리 및 메커니즘

SSH 터널링의 핵심은 캡슐화(Encapsulation)에 있다. 클라이언트가 특정 포트로 데이터를 보내면, SSH 클라이언트는 이 데이터를 SSH 패킷으로 감싸 서버로 전송한다. SSH 서버는 수신한 패킷의 껍질을 벗겨 원래의 데이터를 추출한 뒤, 최종 목적지 포트로 전달한다.

일반 연결 vs SSH 터널링 연결 비교

구분	일반 연결 (Plain Connection)	SSH 터널링 연결 (SSH Tunneled)
데이터 경로	클라이언트 $\rightarrow$ 서비스 서버	클라이언트 $\rightarrow$ SSH 서버 $\rightarrow$ 서비스 서버
암호화 여부	프로토콜 자체 암호화 여부에 의존 (평문 가능성 높음)	SSH 프로토콜에 의해 전체 경로 암호화
방화벽 영향	서비스 포트가 개방되어 있어야 함	SSH 포트(기본 22)만 개방되어 있으면 가능
가시성	패킷 캡처 시 데이터 내용 노출 위험	외부에서는 SSH 트래픽으로만 보임

3. SSH 터널링의 유형

3.1 로컬 포트 포워딩 (Local Port Forwarding)

클라이언트 PC의 특정 포트로 들어오는 접속을 SSH 서버를 거쳐 원격지의 특정 포트로 전달하는 방식이다. 주로 외부에서 접근 불가능한 내부망의 서비스에 접근할 때 사용한다.

개념도: [Local App] $\rightarrow$ [Local Port] $\rightarrow$ (SSH Tunnel) $\rightarrow$ [SSH Server] $\rightarrow$ [Remote Service Port]

명령어 예시:

    # 기본 형태: 로컬 8080 포트를 SSH 서버를 통해 내부망 192.168.0.10:80으로 전달
    ssh -L 8080:192.168.0.10:80 user@ssh-server.com

    # 터널링 전용 실행: 쉘 접속 없이 백그라운드에서 포트 포워딩만 수행
    # -N: 원격 명령어를 실행하지 않음, -f: 인증 후 백그라운드로 전환
    ssh -N -f -L 8080:192.168.0.10:80 user@ssh-server.com

3.2 원격 포트 포워딩 (Remote Port Forwarding)

SSH 서버의 특정 포트로 들어오는 접속을 SSH 클라이언트를 거쳐 클라이언트 측(또는 클라이언트가 접근 가능한) 포트로 전달하는 방식이다. 외부에서 내 로컬 PC의 서비스를 공개하고 싶을 때 사용한다.

개념도: [External User] $\rightarrow$ [SSH Server Port] $\rightarrow$ (SSH Tunnel) $\rightarrow$ [SSH Client] $\rightarrow$ [Local Service Port]

명령어 예시:

    # SSH 서버의 9000 포트로 오는 요청을 내 로컬의 3000 포트로 전달
    ssh -R 9000:localhost:3000 user@ssh-server.com

3.3 다이내믹 포트 포워딩 (Dynamic Port Forwarding)

특정 포트 하나를 지정하는 것이 아니라, SSH 서버를 SOCKS 프록시 서버로 활용하는 방식이다. 클라이언트가 접속하려는 모든 목적지를 SSH 서버가 동적으로 처리한다.

개념도: [Browser/App] $\rightarrow$ [SOCKS Proxy Port] $\rightarrow$ (SSH Tunnel) $\rightarrow$ [SSH Server] $\rightarrow$ [Any Destination]

명령어 예시:

    # 로컬의 1080 포트를 SOCKS 프록시로 설정
    ssh -D 1080 user@ssh-server.com

애플리케이션 설정 방법: 터널 생성 후, 사용하는 브라우저나 OS의 네트워크 설정에서 프록시를 다음과 같이 설정해야 작동한다.
- 프록시 종류: SOCKS v5
- 호스트/주소: localhost 또는 127.0.0.1
- 포트: 1080 (명령어에서 지정한 포트)

4. 주요 활용 사례

내부망 데이터베이스 접근: 보안상 DB 포트(예: MySQL 3306)를 외부에 개방하지 않고, SSH 터널링을 통해 관리자만 안전하게 쿼리 툴로 접속.
방화벽 우회: 특정 웹사이트나 서비스가 사내 방화벽으로 차단되었을 때, 외부 SSH 서버를 경유하여 접속.
로컬 개발 환경 외부 공개: 공인 IP가 없는 로컬 개발 서버를 원격 포트 포워딩을 통해 외부 클라이언트에게 임시로 시연.
안전한 관리 페이지 접속: HTTP로 작동하는 구형 네트워크 장비의 설정 페이지를 SSH 터널로 감싸 스니핑(Sniffing) 공격 방지.

5. OS별 SSH 클라이언트 설치 및 설정

Windows

OpenSSH (내장): 최신 Windows 10/11은 '선택적 기능'에서 OpenSSH 클라이언트를 기본 제공한다. cmd나 PowerShell에서 바로 ssh 명령어를 사용할 수 있다.
PuTTY: 전통적인 GUI 기반 클라이언트. Connection $\rightarrow$ SSH $\rightarrow$ Tunnels 메뉴에서 포트 포워딩 설정을 GUI로 수행할 수 있다.

macOS / Linux

기본 설치: 대부분의 유닉스 계열 OS는 OpenSSH가 기본 설치되어 있다.
설정 최적화: ~/.ssh/config 파일을 통해 복잡한 터널링 명령어를 별칭(Alias)으로 저장하여 사용할 수 있다.
```
    Host my-tunnel
        HostName ssh-server.com
        User myuser
        IdentityFile ~/.ssh/id_rsa
        LocalForward 8080 192.168.0.10:80
    
```
위와 같이 설정하면 ssh my-tunnel 명령어만으로 설정된 포트 포워딩이 자동으로 적용된다.

6. 보안 고려사항 및 서버 설정

6.1 서버측 필수 설정 (`<a href="/doc/%EA%B8%B0%EC%88%A0/%EC%86%8C%ED%94%84%ED%8A%B8%EC%9B%A8%EC%96%B4/%EB%B2%84%EC%A0%84%EA%B4%80%EB%A6%AC/sshd_config" class="wiki-link wiki-link-missing">sshd_config</a>`)

SSH 터널링의 동작을 제어하기 위해 서버의 /etc/ssh/sshd_config 파일에서 다음 설정을 조정할 수 있다. 설정 변경 후에는 반드시 sudo systemctl restart ssh 등으로 서비스를 재시작해야 한다.

GatewayPorts: 원격 포트 포워딩 시 외부 접속 허용 여부를 결정한다.
- GatewayPorts no (기본값): 포워딩된 포트가 localhost에만 바인딩되어 외부에서 접속할 수 없다.
- GatewayPorts yes: 포워딩된 포트가 0.0.0.0으로 바인딩되어 외부의 누구나 해당 포트로 접속할 수 있게 된다. 이는 편리하지만 보안 위험이 따르므로 주의가 필요하다.
AllowTcpForwarding: 포트 포워딩 기능 자체의 활성화 여부를 결정한다.
- AllowTcpForwarding yes (기본값): 터널링 허용.
- AllowTcpForwarding no: 모든 포트 포워딩 기능을 차단하여 보안을 강화한다.

6.2 추가 보안 주의점

인증 강화: 터널링을 허용하는 서버는 반드시 SSH 키 기반 인증을 사용하고, 비밀번호 인증을 비활성화하여 무차별 대입 공격(Brute-force)을 방지해야 한다.

7. 트러블슈팅: 주요 오류 및 해결책

오류 메시지 / 증상	원인	해결책
`Permission denied (publickey)`	인증 키 불일치 또는 서버에 공개키 미등록	`ssh-copy-id`를 통해 공개키를 서버에 등록하거나 올바른 키 경로 지정 (`-i` 옵션)
`bind: Address already in use`	지정한 로컬 포트를 이미 다른 프로세스가 사용 중	`netstat -ano` 또는 `lsof -i`로 포트 확인 후 프로세스 종료 또는 다른 포트 사용
`channel 3: open failed: connect failed`	SSH 서버는 접속되었으나, 최종 목적지 서버/포트로의 연결 실패	SSH 서버에서 목적지 IP/포트로 핑(Ping)이나 텔넷(Telnet) 접속이 가능한지 확인
원격 포워딩 후 외부 접속 불가	`GatewayPorts` 설정이 `no`로 되어 있음	`/etc/ssh/sshd_config`에서 `GatewayPorts yes` 설정 후 SSH 서비스 재시작

8. 요약 및 비교

유형	옵션	방향	주요 용도	특징
로컬 포워딩	`-L`	로컬 $\rightarrow$ 원격	내부망 서비스 접근	클라이언트 포트를 점유함
원격 포워딩	`-R`	원격 $\rightarrow$ 로컬	로컬 서비스 외부 공개	서버 포트를 점유함
다이내믹 포워딩	`-D`	로컬 $\rightarrow$ 모든 곳	프록시 서버 구축	SOCKS 프로토콜 사용, 유연함

📝 마크다운 원본

이 문서의 마크다운 원본 내용입니다.

# SSH 터널링 (SSH Tunneling)

## 1. 개요
**SSH 터널링(SSH Tunneling)**이란 보안되지 않은 네트워크 트래픽을 SSH(Secure Shell) 프로토콜의 암호화된 연결 내부에 캡슐화하여 전송함으로써, 데이터의 기밀성을 보장하고 방화벽 등의 네트워크 제약을 우회하는 네트워크 기술이다.

SSH는 기본적으로 원격 서버에 안전하게 접속하기 위한 프로토콜이지만, 포트 포워딩(Port Forwarding) 기능을 통해 특정 포트의 트래픽을 다른 목적지로 전달하는 '터널' 역할을 수행할 수 있다. 이를 통해 암호화되지 않은 프로토콜(HTTP, VNC, MySQL 등)을 사용하는 서비스도 SSH의 강력한 암호화 계층을 통해 안전하게 통신할 수 있다.

---

## 2. 작동 원리 및 메커니즘
SSH 터널링의 핵심은 **캡슐화(Encapsulation)**에 있다. 클라이언트가 특정 포트로 데이터를 보내면, SSH 클라이언트는 이 데이터를 SSH 패킷으로 감싸 서버로 전송한다. SSH 서버는 수신한 패킷의 껍질을 벗겨 원래의 데이터를 추출한 뒤, 최종 목적지 포트로 전달한다.

### 일반 연결 vs SSH 터널링 연결 비교

| 구분 | 일반 연결 (Plain Connection) | SSH 터널링 연결 (SSH Tunneled) |
| :--- | :--- | :--- |
| **데이터 경로** | 클라이언트 $\rightarrow$ 서비스 서버 | 클라이언트 $\rightarrow$ SSH 서버 $\rightarrow$ 서비스 서버 |
| **암호화 여부** | 프로토콜 자체 암호화 여부에 의존 (평문 가능성 높음) | SSH 프로토콜에 의해 전체 경로 암호화 |
| **방화벽 영향** | 서비스 포트가 개방되어 있어야 함 | SSH 포트(기본 22)만 개방되어 있으면 가능 |
| **가시성** | 패킷 캡처 시 데이터 내용 노출 위험 | 외부에서는 SSH 트래픽으로만 보임 |

---

## 3. SSH 터널링의 유형

### 3.1 로컬 포트 포워딩 (Local Port Forwarding)
클라이언트 PC의 특정 포트로 들어오는 접속을 SSH 서버를 거쳐 원격지의 특정 포트로 전달하는 방식이다. 주로 외부에서 접근 불가능한 내부망의 서비스에 접근할 때 사용한다.

*   **개념도:** `[Local App] $\rightarrow$ [Local Port] $\rightarrow$ (SSH Tunnel) $\rightarrow$ [SSH Server] $\rightarrow$ [Remote Service Port]`
*   **명령어 예시:**
    ```bash
    # 기본 형태: 로컬 8080 포트를 SSH 서버를 통해 내부망 192.168.0.10:80으로 전달
    ssh -L 8080:192.168.0.10:80 user@ssh-server.com

    # 터널링 전용 실행: 쉘 접속 없이 백그라운드에서 포트 포워딩만 수행
    # -N: 원격 명령어를 실행하지 않음, -f: 인증 후 백그라운드로 전환
    ssh -N -f -L 8080:192.168.0.10:80 user@ssh-server.com
    ```

### 3.2 원격 포트 포워딩 (Remote Port Forwarding)
SSH 서버의 특정 포트로 들어오는 접속을 SSH 클라이언트를 거쳐 클라이언트 측(또는 클라이언트가 접근 가능한) 포트로 전달하는 방식이다. 외부에서 내 로컬 PC의 서비스를 공개하고 싶을 때 사용한다.

*   **개념도:** `[External User] $\rightarrow$ [SSH Server Port] $\rightarrow$ (SSH Tunnel) $\rightarrow$ [SSH Client] $\rightarrow$ [Local Service Port]`
*   **명령어 예시:**
    ```bash
    # SSH 서버의 9000 포트로 오는 요청을 내 로컬의 3000 포트로 전달
    ssh -R 9000:localhost:3000 user@ssh-server.com
    ```

### 3.3 다이내믹 포트 포워딩 (Dynamic Port Forwarding)
특정 포트 하나를 지정하는 것이 아니라, SSH 서버를 **SOCKS 프록시 서버**로 활용하는 방식이다. 클라이언트가 접속하려는 모든 목적지를 SSH 서버가 동적으로 처리한다.

*   **개념도:** `[Browser/App] $\rightarrow$ [SOCKS Proxy Port] $\rightarrow$ (SSH Tunnel) $\rightarrow$ [SSH Server] $\rightarrow$ [Any Destination]`
*   **명령어 예시:**
    ```bash
    # 로컬의 1080 포트를 SOCKS 프록시로 설정
    ssh -D 1080 user@ssh-server.com
    ```
*   **애플리케이션 설정 방법:**
    터널 생성 후, 사용하는 브라우저나 OS의 네트워크 설정에서 프록시를 다음과 같이 설정해야 작동한다.
    - **프록시 종류:** SOCKS v5
    - **호스트/주소:** `localhost` 또는 `127.0.0.1`
    - **포트:** `1080` (명령어에서 지정한 포트)

---

## 4. 주요 활용 사례
1.  **내부망 데이터베이스 접근:** 보안상 DB 포트(예: MySQL 3306)를 외부에 개방하지 않고, SSH 터널링을 통해 관리자만 안전하게 쿼리 툴로 접속.
2.  **방화벽 우회:** 특정 웹사이트나 서비스가 사내 방화벽으로 차단되었을 때, 외부 SSH 서버를 경유하여 접속.
3.  **로컬 개발 환경 외부 공개:** 공인 IP가 없는 로컬 개발 서버를 원격 포트 포워딩을 통해 외부 클라이언트에게 임시로 시연.
4.  **안전한 관리 페이지 접속:** HTTP로 작동하는 구형 네트워크 장비의 설정 페이지를 SSH 터널로 감싸 스니핑(Sniffing) 공격 방지.

---

## 5. OS별 SSH 클라이언트 설치 및 설정

### Windows
*   **OpenSSH (내장):** 최신 Windows 10/11은 '선택적 기능'에서 OpenSSH 클라이언트를 기본 제공한다. `cmd`나 `PowerShell`에서 바로 `ssh` 명령어를 사용할 수 있다.
*   **PuTTY:** 전통적인 GUI 기반 클라이언트. `Connection` $\rightarrow$ `SSH` $\rightarrow$ `Tunnels` 메뉴에서 포트 포워딩 설정을 GUI로 수행할 수 있다.

### macOS / Linux
*   **기본 설치:** 대부분의 유닉스 계열 OS는 `OpenSSH`가 기본 설치되어 있다.
*   **설정 최적화:** `~/.ssh/config` 파일을 통해 복잡한 터널링 명령어를 별칭(Alias)으로 저장하여 사용할 수 있다.
    ```sshconfig
    Host my-tunnel
        HostName ssh-server.com
        User myuser
        IdentityFile ~/.ssh/id_rsa
        LocalForward 8080 192.168.0.10:80
    ```
    위와 같이 설정하면 `ssh my-tunnel` 명령어만으로 설정된 포트 포워딩이 자동으로 적용된다.

---

## 6. 보안 고려사항 및 서버 설정

### 6.1 서버측 필수 설정 (`sshd_config`)
SSH 터널링의 동작을 제어하기 위해 서버의 `/etc/ssh/sshd_config` 파일에서 다음 설정을 조정할 수 있다. 설정 변경 후에는 반드시 `sudo systemctl restart ssh` 등으로 서비스를 재시작해야 한다.

*   **GatewayPorts:** 원격 포트 포워딩 시 외부 접속 허용 여부를 결정한다.
    - `GatewayPorts no` (기본값): 포워딩된 포트가 `localhost`에만 바인딩되어 외부에서 접속할 수 없다.
    - `GatewayPorts yes`: 포워딩된 포트가 `0.0.0.0`으로 바인딩되어 외부의 누구나 해당 포트로 접속할 수 있게 된다. 이는 편리하지만 보안 위험이 따르므로 주의가 필요하다.
*   **AllowTcpForwarding:** 포트 포워딩 기능 자체의 활성화 여부를 결정한다.
    - `AllowTcpForwarding yes` (기본값): 터널링 허용.
    - `AllowTcpForwarding no`: 모든 포트 포워딩 기능을 차단하여 보안을 강화한다.

### 6.2 추가 보안 주의점
*   **인증 강화:** 터널링을 허용하는 서버는 반드시 **SSH 키 기반 인증**을 사용하고, 비밀번호 인증을 비활성화하여 무차별 대입 공격(Brute-force)을 방지해야 한다.

---

## 7. 트러블슈팅: 주요 오류 및 해결책

| 오류 메시지 / 증상 | 원인 | 해결책 |
| :--- | :--- | :--- |
| `Permission denied (publickey)` | 인증 키 불일치 또는 서버에 공개키 미등록 | `ssh-copy-id`를 통해 공개키를 서버에 등록하거나 올바른 키 경로 지정 (`-i` 옵션) |
| `bind: Address already in use` | 지정한 로컬 포트를 이미 다른 프로세스가 사용 중 | `netstat -ano` 또는 `lsof -i`로 포트 확인 후 프로세스 종료 또는 다른 포트 사용 |
| `channel 3: open failed: connect failed` | SSH 서버는 접속되었으나, 최종 목적지 서버/포트로의 연결 실패 | SSH 서버에서 목적지 IP/포트로 핑(Ping)이나 텔넷(Telnet) 접속이 가능한지 확인 |
| 원격 포워딩 후 외부 접속 불가 | `GatewayPorts` 설정이 `no`로 되어 있음 | `/etc/ssh/sshd_config`에서 `GatewayPorts yes` 설정 후 SSH 서비스 재시작 |

---

## 8. 요약 및 비교

| 유형 | 옵션 | 방향 | 주요 용도 | 특징 |
| :--- | :---: | :---: | :--- | :--- |
| **로컬 포워딩** | `-L` | 로컬 $\rightarrow$ 원격 | 내부망 서비스 접근 | 클라이언트 포트를 점유함 |
| **원격 포워딩** | `-R` | 원격 $\rightarrow$ 로컬 | 로컬 서비스 외부 공개 | 서버 포트를 점유함 |
| **다이내믹 포워딩** | `-D` | 로컬 $\rightarrow$ 모든 곳 | 프록시 서버 구축 | SOCKS 프로토콜 사용, 유연함 |

AI 생성 콘텐츠 안내

이 문서는 AI 모델(gemma-4-31b)에 의해 생성된 콘텐츠입니다.

주의사항: AI가 생성한 내용은 부정확하거나 편향된 정보를 포함할 수 있습니다. 중요한 결정을 내리기 전에 반드시 신뢰할 수 있는 출처를 통해 정보를 확인하시기 바랍니다.

위키너와나

SSH 터널링

SSH 터널링 (SSH Tunneling)

1. 개요

2. 작동 원리 및 메커니즘

일반 연결 vs SSH 터널링 연결 비교

3. SSH 터널링의 유형

3.1 로컬 포트 포워딩 (Local Port Forwarding)

3.2 원격 포트 포워딩 (Remote Port Forwarding)

3.3 다이내믹 포트 포워딩 (Dynamic Port Forwarding)

4. 주요 활용 사례

5. OS별 SSH 클라이언트 설치 및 설정

Windows

macOS / Linux

6. 보안 고려사항 및 서버 설정

6.1 서버측 필수 설정 (`<a href="/doc/%EA%B8%B0%EC%88%A0/%EC%86%8C%ED%94%84%ED%8A%B8%EC%9B%A8%EC%96%B4/%EB%B2%84%EC%A0%84%EA%B4%80%EB%A6%AC/sshd_config" class="wiki-link wiki-link-missing">sshd_config</a>`)

6.2 추가 보안 주의점

7. 트러블슈팅: 주요 오류 및 해결책

8. 요약 및 비교

📝 마크다운 원본

🤔 AI의 사고 과정

이 AI 생성 콘텐츠가 도움이 되었나요?

SSH 터널링 (SSH Tunneling)

1. 개요

2. 작동 원리 및 메커니즘

일반 연결 vs SSH 터널링 연결 비교

3. SSH 터널링의 유형

3.1 로컬 포트 포워딩 (Local Port Forwarding)

3.2 원격 포트 포워딩 (Remote Port Forwarding)

3.3 다이내믹 포트 포워딩 (Dynamic Port Forwarding)

4. 주요 활용 사례

5. OS별 SSH 클라이언트 설치 및 설정

Windows

macOS / Linux

6. 보안 고려사항 및 서버 설정

6.1 서버측 필수 설정 (<a href="/doc/%EA%B8%B0%EC%88%A0/%EC%86%8C%ED%94%84%ED%8A%B8%EC%9B%A8%EC%96%B4/%EB%B2%84%EC%A0%84%EA%B4%80%EB%A6%AC/sshd_config" class="wiki-link wiki-link-missing">sshd_config</a>)

6.2 추가 보안 주의점

7. 트러블슈팅: 주요 오류 및 해결책

8. 요약 및 비교

📝 마크다운 원본

🤔 AI의 사고 과정

이 AI 생성 콘텐츠가 도움이 되었나요?

6.1 서버측 필수 설정 (`<a href="/doc/%EA%B8%B0%EC%88%A0/%EC%86%8C%ED%94%84%ED%8A%B8%EC%9B%A8%EC%96%B4/%EB%B2%84%EC%A0%84%EA%B4%80%EB%A6%AC/sshd_config" class="wiki-link wiki-link-missing">sshd_config</a>`)